Skip to content

Get tenant app by ID
Stable

Request

Retrieves a single tenant app's detail record by its ID.

Returns the TenantAppResponse object for the given appId, including its platform, package name, and audit timestamps.

About Get Tenant App

⚠️ iOS and Windows only. This is the single-app counterpart to the tenant apps list, useful once you already have an appId and need its current record.

Common Use Cases

Confirming an app's platform and package name before referencing it in a blueprint

Checking when an app record was last updated

Best Practices

Use GET /v2/tenant-apps/{appId}/versions immediately after this call if you need the app's installable versions, since this endpoint does not return version detail

Workflow

Obtain the appId from the tenant apps list or from the upload response

Call this endpoint to retrieve its detail record

Security
apps_management_apiKey
Path
appIdstring, (uuid)required
cURL
curl -i -X GET \
  'https://api.esper.io/_mock/openapi/v2/tenant-apps/{appId}' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

Success

Bodyapplication/json
contentobject(apps_management_TenantAppResponse)
Response
{
  "content": {
    "id": "string",
    "platform": "APPLE",
    "tenant_id": "string",
    "package_name": "string",
    "created_at": "2019-08-24T14:15:22Z",
    "created_by": "string",
    "updated_at": "2019-08-24T14:15:22Z",
    "updated_by": "string"
  }
}